Carbon


GetThemeDrawingState

Header: Appearance.h Carbon status: Supported

Obtains the drawing state of the current graphics port.

OSStatus GetThemeDrawingState (
    ThemeDrawingState *outState
);
Parameter descriptions
outState

A pointer to a value of type ThemeDrawingState. On return, GetThemeDrawingState sets the outState parameter to point to a copy of the drawing state for the current graphics port.

function result

A result code.

DISCUSSION

Your application may call the GetThemeDrawingState function before performing an operation that modifies the drawing state of a graphics port. To return the graphics port to its previous drawing state and release the memory allocated for the drawing state reference, your application should call SetThemeDrawingState, providing the reference obtained in the outState parameter of GetThemeDrawingState. You can also call DisposeThemeDrawingState to release the allocated memory.

VERSION NOTES

This function is available with Appearance Manager 1.1 or later.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)